P4 is distributed with a set of routines for creating logfiles (see README in the p4/alog directory. The resulting logfiles can be examined by upshot, distributed separately. For details about upshot, see [#!herrarte-lusk:upshot!#].
The p4/alog directory contains a package (ALOG) for creating logs of time-stamped events, that is of general utility, outside of p4. The timestamps are obtained from various microsecond-level resolution timers on various machines. The portable microsecond timing package is contained in the usc subdirectory. It is used by the ALOG package as well as by the p4_ustimer function in p4. Similarly, the ALOG package can be used independently of p4 and upshot. Its logfiles were designed to be read and displayed by upshot, but other display packages can be used as well.
User-Specified Events,Examining Log Files with Upshot, ,Creating Logfiles for Upshot